home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 16 / fspell3a.zip / FSPDOC.DOC next >
Text File  |  1987-04-04  |  43KB  |  1,002 lines
  1.  
  2.  
  3.          ╔═══════════════════════════════════════════════════════════╗
  4.          ║╔═════════════════════════════════════════════════════════╗║
  5.          ║║          FolkSpeller        Version 3.1    SN:xxxxx     ║║
  6.          ║║                                                         ║║
  7.          ║║                Copyright 1985, 1986                     ║║
  8.          ║║                                                         ║║
  9.          ║║                by The FolksWare Company                 ║║
  10.          ║║                   PO Box 720741                         ║║
  11.          ║║                   Houston, Texas    77272-0741          ║║
  12.          ║╚═════════════════════════════════════════════════════════╝║
  13.          ╚═══════════════════════════════════════════════════════════╝
  14.  
  15.     Welcome to FolkSpeller, a text file spelling checker program that will
  16.     allow you to correct misspelled words as they are found in the file. If
  17.     you use your computer for writing letters, articles, books, or
  18.     documentation, and have as much trouble with spelling, and 'fat' finger
  19.     errors as I do, you will find this program a handy tool to have.
  20.     FolkSpeller stores the correctly spelled words in a dictionary, and
  21.     looks up each word in a document to verify the spelling. FolkSpeller has
  22.     a few more functions that make it an excellent tool for a writer.
  23.     FolkSpeller will display how many words were checked in a document, and
  24.     create a concordance of unique words used since it was started. You may
  25.     also add your own words to the dictionary, or use a special word list.
  26.     We hope you will find the program useful. Fred Guymon
  27.  
  28.  
  29. LEGALITIES
  30.  
  31.     This software is protected by both United States Copyright Law and
  32.     International Copyright Treaty provisions. You are allowed to make
  33.     copies of the software for archival purposes, and for evaluation
  34.     distribution. By evaluation distribution, FolksWare means that you may
  35.     copy the main operating program, configuration files, and documentation
  36.     files, and distribute them to any one who would like to evaluate the
  37.     program. You are not allowed to modify the programs or documentation in
  38.     any way, nor are you allowed to charge more than a nominal fee of $5.00
  39.     for distribution and copying costs.
  40.  
  41.     If you receive a copy of this software, please take some
  42.     time to evaluate the program. If you decide that the
  43.     program has value to you in your use of a computer, and you keep a copy
  44.     of the program, you must legally purchase the program by sending
  45.     a check or money order to:
  46.  
  47.                  The FolksWare Company
  48.                  P.O. Box 720741
  49.                  Houston, Texas 77272-0741
  50.  
  51.  
  52.     FOLKSPELLER, Copyright The FolksWare Company, 1985,1986
  53.  
  54.  
  55.     * * * * ONE MORE REASON TO PURCHASE THE PROGRAM * * * *
  56.  
  57.     If you decide to purchase the FolkSpeller program, you may order The
  58.     FolksWare Dictionary, which contains 30,000 common English words, and
  59.     can be used with the FolkSpeller program. The cost of the Dictionary
  60.     is only $5.00 when purchased with FolkSpeller. If you also send a
  61.     formatted (MS-DOS) diskette, and a prepaid mailer with your purchase
  62.     request, you will receive a $5.00 credit, making the total price of
  63.     the spelling checker and the dictionary only $10.00.
  64.  
  65.     We think this is quite a value, and we hope you will think so too. The
  66.     dictionary has been optimized to run very fast on your machine, as well
  67.     as having verified words in the dictionary. We will also tell you
  68.     how to use the other parameters that we have installed for the
  69.     program. For more information, see our order form on file FSPORDER.FRM
  70.     included on the distribution disk.
  71.  
  72.     The dictionary that is distributed with FolkSpeller, contains only a
  73.     few thousand words, enough to show you the operational characteristics
  74.     of the program. You may add words to the dictionary, but it would be so
  75.     much simpler to order our dictionary. The words you add must be spelled
  76.     correctly or the spelling checker will be of little value.
  77.     We save you the time of verifying the spelling of over 30,000 words.
  78.  
  79.     Distribution is based on the 'Honor System'. You are on your honor to
  80.     purchase the software, if you decide to keep it. If you do not keep the
  81.     software, you do not owe any money at all, but please feel free to
  82.     distribute your copy to a friend who may be able to use the program.
  83.  
  84.     **********************************************************************
  85.  
  86.     The FolksWare Dictionary is a copyrighted dictionary file, and is not
  87.     to be distributed  by any method without the express permission of The
  88.     FolksWare Company. It is a violation of the law to copy and distribute
  89.     the FolksWare Dictionary (FW86.DCT) without proper payment and permission.
  90.  
  91.     If you had spent the amount of time that we have, you would feel very
  92.     cheated to find some one distributing the fruits of your labor, without
  93.     proper payment. Please be honest with yourself and us, and if you keep
  94.     the program, legally purchase the program. Thank You.
  95.  
  96.     **********************************************************************
  97.  
  98.  
  99.     FOLKSPELLER, Copyright The FolksWare Company, 1985,1986
  100.  
  101.     FolksWare does not have a site license as such, but we do offer a
  102.     substantial discount for multiple quantity users. After purchasing the
  103.     initial program, if you need more than one copy at a particular site,
  104.     you may register/purchase any additional copies of the FolkSpeller
  105.     program  and the FolksWare Dictionary that you create for $5.00 per set.
  106.     Since FolkSpeller and The FolksWare Dictionary is not copy protected,
  107.     you should make your own copies for each user.  Again, this is to be done
  108.     using the 'HONOR' system. FolksWare defines 'site' as one or more
  109.     buildings, interconnected in such a way as to be considered part of one
  110.     office complex at one location. The following is a list of files you
  111.     should have received on the distribution evaluation disk:
  112.  
  113.                       FSPELL.COM     FSPORDER.FRM
  114.                       FSPELL.CFG     FSPTEST.TUT
  115.                       FSPELL.DCT     FSPDOC.DOC
  116.                       MSDOS.SP ***** Only with purchase
  117.      MSDOS.SP - is a special word list with words used in describing Computer
  118.                 functions such as DISKCOPY, CONFIG.SYS, etc.
  119.  
  120.  
  121. WARRANTY
  122.  
  123.     The FolksWare Company warrants the physical disks distributed by
  124.     FolksWare themselves, to be free of defects in materials and
  125.     workmanship for a period of 30 days from the date of purchase. If there
  126.     is a problem with one of the disks, and this defect is reported to
  127.     FolksWare during the warranty period, return the disk, and
  128.     FolksWare will replace the diskette free of charge. FolksWare's
  129.     liability shall be limited to replacement of defective diskettes, and
  130.     shall not encompass any other damages, including, but not limited to
  131.     loss of profit, special, consequential, incidental or other similar
  132.     claims of loss.
  133.  
  134.     **********************************************************************
  135.  
  136.     THE FOLKSWARE COMPANY, SPECIFICALLY DISCLAIMS ALL OTHER EXPRESSED OR
  137.     IMPLIED WARRANTIES INCLUDING, BUT NOT LIMITED TO  IMPLIED WARRANTIES OF
  138.     MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. FOLKSWARE SHALL IN
  139.     NO EVENT BE HELD LIABLE FOR ANY LOSS OF PROFIT, OR ANY OTHER COMMERCIAL
  140.     DAMAGE, INCLUDING, BUT NOT LIMITED TO SPECIAL, INCIDENTAL, OR OTHER
  141.     DAMAGES.
  142.  
  143.     **********************************************************************
  144.  
  145.  
  146.  
  147.     FOLKSPELLER, Copyright The FolksWare Company, 1985,1986
  148.  
  149.  
  150.     It is the responsibility of the person evaluating the product to
  151.     determine its fitness for use. The program was developed on an AT&T
  152.     6300 microcomputer, and has been tested on IBM-PC's and several
  153.     "work-a-like" computers.  It should run on most all IBM 'look-a-like'
  154.     computers, as long as they are IBM compatible. If it does not run on
  155.     your machine, we would appreciate your dropping us a line listing your
  156.     configuration and what it does  or does not do. It is our intent to
  157.     support this product by updating it to work on as many IBM type
  158.     computers as we can reasonably manage. The amount of effort that we
  159.     put into the support of the product, will depend entirely on the amount
  160.     of effort you, the user community, support us. You may write to us
  161.     with any questions you have about the program at the address above. We
  162.     will try to answer those questions, but will limit answers to registered
  163.     owners only.
  164.  
  165.     Use of this program constitutes acceptance of the terms of warranty and
  166.     of financial responsibility for such use.
  167.  
  168.     BACKUP your disks
  169.     -----------------
  170.     Before doing any thing, copy the original distribution disk to a working
  171.     disk, and store the original in a safe place. We recommend saving an
  172.     original copy of the dictionary, in case the user adds incorrectly
  173.     spelled words, he may reset to the initial set of words. The dictionary
  174.     file should be treated as you would any other data base with stored
  175.     data, i.e. the proper backup procedures should be followed.
  176.  
  177.     The FolkSpeller dictionaries are capable of storing 100,000+ words on a
  178.     hard drive, or 40,000+ words on a floppy disk. Since FolkSpeller uses
  179.     data compaction, and suffix extraction, the actual number of words stored
  180.     on either medium is not able to be determined. Theoretically, the
  181.     dictionary can store 1,800,000 different words, 370,000 on a diskette.
  182.  
  183.  
  184.  
  185.  
  186.     FOLKSPELLER, Copyright The FolksWare Company, 1985,1986
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.     FolkSpeller - Manual
  197.  
  198. Table of contents:
  199. _______________________________________________________________
  200.  
  201.  
  202.  
  203.  
  204. 1. Running FOLKSPELLER
  205.  
  206. 2. Main Menu
  207.  
  208.      Spelling Menu
  209.  
  210.      Dictionary Menu
  211.  
  212.      Words Menu
  213.  
  214.      MiniDOS Menu
  215.  
  216. 3. Configuring FolkSpeller
  217.  
  218.  
  219. 4. Tips
  220.  
  221.  
  222. 5. Recommended configurations
  223.  
  224.  
  225.  
  226.  
  227.     FOLKSPELLER, Copyright The FolksWare Company, 1985,1986
  228.  
  229.  
  230.  
  231. 1. RUNNING FolkSpeller
  232.  
  233.    Two Drive system......
  234.  
  235.    To run FolkSpeller, place the program disk in drive A, your document disk
  236.    in drive B, and type FSPELL.
  237.  
  238.    The program will load itself, and present you with the intro screen.
  239.    After a short pause, you may press 'Q' to quit or any other key to start
  240.    the program which will then display the main menu screen. FolkSpeller uses
  241.    a built in set of defaults unless a configuration file is available on the
  242.    program disk. See Configuring FolkSpeller. You should now remove the
  243.    FolkSpeller disk and replace it with your Dictionary disk. If your
  244.    dictionary is stored on the same disk as FolkSpeller, just leave it in
  245.    the drive.
  246.  
  247.    One drive system......
  248.  
  249.    If you have a single disk drive, at the "continue" prompt, insert the
  250.    dictionary disk into the drive at his time. Note that the document that you
  251.    want to check must be on the dictionary disk.
  252.  
  253.    In either case, there must be enough room on the disk for a back-up copy of
  254.    the document plus the dictionary, and any words you will add to it. If
  255.    there is not enough room on the disk, and a ".BAK" file exists, you will be
  256.    given an opportunity to delete that file and continue.
  257.  
  258.  
  259. MAIN MENU
  260. ---------
  261. ╔═════════════════════════════════════════════════════════════════════════════╗
  262. ║ FolkSpeller - Copyright The FolksWare Company, 1985,1986   Ver 3.1          ║
  263. ╠═════════════════════════════════════════════════════════════════════════════╣
  264. ║                                                                             ║
  265. ║<MENU> Spelling  Dictionary  Words(special)  MiniDOS   CONF   Help  Quit     ║
  266. ╚═════════════════════════════════════════════════════════════════════════════╝
  267.  
  268.    FolkSpeller is a menu driven program. All the menus will be displayed as the
  269.    one above. The menu title will be displayed at the left of the command line
  270.    in <xxx>. To initiate a command, you press the first letter of the command
  271.    (upper or lower case).  If there is a '<CR>' at the extreme right of the
  272.    command line, you must press the enter or carriage return key after the
  273.    letter. In MiniDOS, you must type the commands, similar to DOS.
  274.  
  275.  
  276.  
  277.  
  278.     FOLKSPELLER, Copyright The FolksWare Company, 1985,1986
  279.  
  280.  
  281.  
  282.    Wherever a help screen is available, you may press or enter 'H' to view
  283.    the screen. To Quit a particular menu, or the program, pressing or
  284.    entering 'Q' will either terminate FolkSpeller from the main menu, or
  285.    return to the main menu from a sub menu.
  286.  
  287.    For instance, if you wanted to activate the spelling checker, you would
  288.    press the letter 'S', and you will notice that the command line will
  289.    change to the <SPELLING> menu.
  290.  
  291.  
  292.  
  293. SPELLING - menu:
  294. ----------------
  295.  
  296. ╔═════════════════════════════════════════════════════════════════════════════╗
  297. ║ FolkSpeller - Copyright The FolksWare Company, 1985,1986    VER 3.1         ╟
  298. ╠═════════════════════════════════════════════════════════════════════════════╣
  299. ║                                                                             ║
  300. ║ <SPELLING CHECK>  Add  Correct  Find  Mark  TempW  SpclWord   Help Quit     ║
  301. ╚═════════════════════════════════════════════════════════════════════════════╝
  302.  
  303.                  Enter filename (Def Drv = B:)...
  304.  
  305.  
  306.  
  307.    If you have selected the Spelling option from the main menu, you are now
  308.    ready to check the spelling of a document. You must enter the file name of
  309.    the document.  Notice the prompt for a file name under the menu header.  The
  310.    default file drive designator is shown in the prompt. If you want to change
  311.    the default drive, simply prefix the file name with a drive designator and a
  312.    colon, i.e. 'C:FILE.DOC'. If you enter a file name that can not be found,
  313.    another prompt will give you a chance to retry an entry. If you do not want
  314.    to check a document, entering nothing, and answering 'N' to the request to
  315.    try again will return you to the MAIN menu.
  316.  
  317.    FolkSpeller will check the spelling of words in standard ASCII text files,
  318.    looking only at alphabetic words. Special symbols for formatting are
  319.    ignored.
  320.  
  321.  
  322.  
  323.  
  324.  
  325.    * * * * *       Try FSPTEST.TUT to learn the features of the program.......
  326.  
  327.  
  328.  
  329.     FOLKSPELLER, Copyright The FolksWare Company, 1985,1986
  330.  
  331.  
  332.    Once a file name has been entered, and found on the disk, the program
  333.    will open the dictionary file, and start reading the document that you
  334.    specified, and verify each word it finds, by looking it up in the
  335.    dictionary. The program decides it has found a word when it finds two or
  336.    more letters in a row, terminated with a non-letter. Words with only one
  337.    letter are accepted as they are. Contractions or possessives, with
  338.    embedded apostrophes such as"train's" or "don't" will be looked up in
  339.    the dictionary. Hyphenated words are verified in parts separated by the
  340.    hyphen. Words that have imbedded symbols or numbers, will also be
  341.    verified in parts. The program will look up words regardless of whether
  342.    they are upper, lower, or a combination of both cases. Words continued
  343.    with a hyphen at the end of the line will be checked as one single
  344.    word.
  345.  
  346.   NOTE: If a dictionary file is not found on the drive, one will be created
  347.         named FSPELL.DCT with no words. The dictionary requires about 13K
  348.         in its initial form. This space is used as words are added.
  349.  
  350.    As words are verified, they will be displayed on the screen.
  351.    If a word is not found in the dictionary, the program will stop, highlight
  352.    the word on the screen, and wait for your command for what to do next.
  353.    Pressing the space bar, or any key except a command key will accept the
  354.    word into the document just the way it is spelled and restart the checking
  355.    process with the next word.
  356.  
  357.     Add - command:
  358.  
  359.        Pressing 'A' will add the word to the dictionary the way it is
  360.        currently spelled. After adding the word, it will be accepted
  361.        whenever it is found again. Remember, that if you add a
  362.        misspelled word to the dictionary, then the program will accept
  363.        that spelling wherever it finds it. Some words longer than 15
  364.        characters will not be added to the dictionary, but will be added
  365.        to the special words list.  The dictionary extracts several suffixes
  366.        from words so some long words will be stored. See SpecialWord command
  367.        below. If there is not room on the disk to add new words, you will
  368.        receive a DISK FULL - CAN'T ADD error message.
  369.  
  370.     Replace - command:
  371.  
  372.        If the highlighted word was corrected earlier, the program will
  373.        display a prompt above the text such as:
  374.  
  375.                  Replace with 'school'?
  376.  
  377.        Pressing 'R' will then replace the spelling of the word. You may
  378.        also configure FolkSpeller to automatically replace words once they are
  379.        corrected. See Configuring FolkSpeller.
  380.  
  381.  
  382.  
  383.  
  384.     FOLKSPELLER, Copyright The FolksWare Company, 1985,1986
  385.  
  386.  
  387.     Correct - command:
  388.  
  389.        Pressing 'C' will allow you to correct the spelling of the word. To
  390.        correct, simply type the correct spelling over the incorrect word. Be
  391.        sure and type the whole word the way you want it to appear in the
  392.        document.  Do not worry if the old word is longer, as these extra
  393.        characters will be thrown away. When you are finished, press the ENTER
  394.        key. Pressing the ENTER key with no changes leaves the word unchanged.
  395.        The program will recheck the spelling of the corrected word. If it
  396.        is still incorrect or not found, the program will stop again. If for
  397.        some reason, you want to use this spelling of the word, but do not want
  398.        to add it to the dictionary just press the space bar. The new spelling
  399.        will be used for this word, and be used to manually or automatically
  400.        replace the word later in the document.
  401.  
  402.        NOTE: To correct a continued word, a prompt will ask you to enter the
  403.        word including a hyphen, if you want the word broken at the end of the
  404.        line. These corrected words are not added to the replace word queue.
  405.  
  406.     Find - command: (new for version 3.1)
  407.  
  408.        The find command will initiate a series of tests and look up to find
  409.        words that are spelled similar to the word that is highlighted. Since
  410.        the words it finds are limited to words in the dictionary, we
  411.        recommend using this command only when using the FolksWare dictionary.
  412.        The command will work with any dictionary. Words that are similar
  413.        will be displayed in a popup window above the highlighted word.
  414.        You may use these words as a guide for correction of the misspelled
  415.        word. If you purchase the FolksWare dictionary, we will tell you
  416.        how to initiate a more complete set of tests to find the corrected
  417.        spelling of a word. After the dictionary has been searched, the
  418.        program is ready for another command such as 'C'orrect.
  419.  
  420.     Mark - command:
  421.  
  422.        If you are not sure of the spelling, and would like to correct the
  423.        spelling later, you may mark the word with a special character by
  424.        pressing 'M'. This option will replace the last character of the
  425.        word with whatever character you are using for marking (see
  426.        Configuring FolkSpeller). After finishing the document, you may
  427.        then start your word processor and use the FIND function to locate
  428.        all the words you marked. Using this function will not change the
  429.        length of the lines in the document.
  430.  
  431.  
  432.  
  433.     FOLKSPELLER, Copyright The FolksWare Company, 1985,1986
  434.  
  435.  
  436.     TempW - command:
  437.  
  438.        Pressing 'T' will add the word to a temporary word list.  Often
  439.        there are several words that are specific to a particular
  440.        document. Words such as proper names, addresses, slang, or
  441.        combinations of letters that have a special meaning to your
  442.        intended reader such as IEEE, NAPA, or Fred may be added to the
  443.        temporary word list when they are first found in the document.
  444.        From that point on, they will be accepted when they are found in
  445.        the text. This option speeds up the checking process, but
  446.        remember, these are temporary words. When checking several
  447.        documents, the temporary word list is cumulative until FolkSpeller
  448.        is terminated.
  449.  
  450.     SpecialWord - command:
  451.  
  452.        Pressing 'S' adds the word to the special words list. Many times,
  453.        the writer will be using words peculiar to a specific subject such
  454.        as medicine, or engineering, or computing.  If there are several
  455.        special words that you find you need to use, but do not want to
  456.        store them in the dictionary, you may add these words to the
  457.        special word list. This list works just like the temporary word
  458.        list except that at the end of the session, you may save these
  459.        words to a file. You may reuse the list for other documents later
  460.        by selecting the WORDS option on the MAIN menu, and loading these
  461.        into the program before checking documents. (See Words Menu)
  462.  
  463.  
  464.        NOTE: The maximum length of words stored in the dictionary is 15
  465.        characters. Occasionally, you may use words greater than the
  466.        maximum. These words will not be found, and if you wish to prevent
  467.        the pause, you must either add them to the temporary or special
  468.        word list. You could create a list of special words for a specific
  469.        subject matter, such as medical terminology, and then load these
  470.        words into the program before checking  that kind of document. Also,
  471.        if there is not enough memory on your machine to add new words to
  472.        memory, you will receive a MEMORY FULL - CAN'T ADD message.
  473.  
  474.  
  475.     Quit - command:
  476.  
  477.        Pressing 'Q' will allow you to terminate checking a document. While
  478.        the document is being scanned, you may have to hold the 'Q' key
  479.        down for a second or two to get it to stop. Once stopped, you
  480.        will need to verify that you do wish to quit in the middle of the
  481.        document.  If you press 'Y', the program will save the unchecked
  482.        portion with as much of the document as you have checked.
  483.        Pressing 'N' returns you to checking. An optional exit without
  484.        saving the previous work has been added to the quit options. Pressing
  485.  
  486.  
  487.  
  488.     FOLKSPELLER, Copyright The FolksWare Company, 1985,1986
  489.  
  490.  
  491.        'X' at the quit prompt will terminate checking the current document,
  492.        without creating a corrected version of the document. This option
  493.        will only work from the quit prompt.
  494.  
  495.        At the end of a document, the program reverts to the main menu, with
  496.        a mini report for that document. The report tells the user how many
  497.        words were checked in the document, how many special words have been
  498.        added since the program was started, and if you are creating a
  499.        concordance, how many unique words you have used. The number of special
  500.        and concordance words is cumulative until FolkSpeller is terminated. For
  501.        more about the concordance  see Tips.
  502.  
  503.  
  504. Dictionary Menu:
  505. ----------------
  506.  
  507.    Selecting 'D' from the main menu, starts the dictionary maintenance part
  508.    of the program. You should see the following menu on your display.
  509.  
  510.  
  511.  
  512. ╔═════════════════════════════════════════════════════════════════════════════╗
  513. ║ FolkSpeller - Copyright The FolksWare Company, 1985,1986   VER. 3.1         ║
  514. ╠═════════════════════════════════════════════════════════════════════════════╣
  515. ║                                                                             ║
  516. ║<DICT. MAINT.>  Enter word to Add, Del, or Correct           Help  Quit <CR> ║
  517. ╚═════════════════════════════════════════════════════════════════════════════╝
  518.  
  519.  
  520.  
  521.    Enter a word at the prompt 'Which word:'.  You can then add the word to
  522.    the dictionary by pressing 'A', or delete the word from the dictionary by
  523.    pressing 'D', or you may correct the spelling of the word by pressing
  524.    'C'.
  525.  
  526.         If you try to add an existing word, the program will warn you by
  527.         displaying 'word already exists.'
  528.  
  529.         If you try to delete a non-existing word, the program will warn you
  530.         by displaying 'word does not exist.'
  531.  
  532.         If you try to correct a non-existing word, the program will warn you
  533.         by displaying 'word does not exist.'
  534.  
  535.         Entering 'Q' will terminate the dictionary maintenance portion of
  536.         the program, and return the user to the main menu.
  537.  
  538.  
  539.  
  540.     FOLKSPELLER, Copyright The FolksWare Company, 1985,1986
  541.  
  542.  
  543.    NOTE: If you have checked a document that contained a word that is deleted
  544.    later, FolkSpeller will still recognize the word if was added to the
  545.    temporary, or special word list, or if it was added to the concordance.
  546.    You must restart FolkSpeller from DOS to eliminate these words.
  547.  
  548.  
  549.  
  550. Words(special) menu:
  551. --------------------
  552.  
  553. Selecting 'W' from the main menu will allow loading or saving of the special
  554. word list or the concordance.
  555.  
  556.  
  557. ╔═════════════════════════════════════════════════════════════════════════════╗
  558. ║ FolkSpeller - Copyright The FolksWare Company, 1985,1986  VER 3.1           ║
  559. ╠═════════════════════════════════════════════════════════════════════════════╣
  560. ║                                                                             ║
  561. ║<WORDS>  LoadSpecWords  SaveSpecWords  Concordance            Help  Quit     ║
  562. ╚═════════════════════════════════════════════════════════════════════════════╝
  563.  
  564.  
  565.  
  566.    LoadSpecWords - command
  567.  
  568.       Pressing 'L' will allow the user to load a list of special words
  569.       from a text file on a disk, into the special words list in the
  570.       program. The program will ask for the name of the word list file.
  571.  
  572.       The text file list of words must be formatted one lowercase word
  573.       per line, and preferably in random order. Several special word lists
  574.       may be used at one time, by adding them one right after the other. These
  575.       words will be accepted by the spelling checker when found in a document
  576.       until the termination of FolkSpeller.
  577.       Special word list files may be created by using FolkSpeller to check a
  578.       document full of special words, and adding them to the special list,
  579.       and then saving those words in a file using the SaveSpecWords option.
  580.  
  581.   SaveSpecWords - command
  582.  
  583.       Pressing 'S' will allow the user to save all the words in the
  584.       special words list of the program to a disk file. The program will
  585.       ask for the name of the word list file to save. If the file
  586.       exists, the user will be asked if he wishes to overwrite that file
  587.       or not.
  588.  
  589.  
  590.  
  591.     FOLKSPELLER, Copyright The FolksWare Company, 1985,1986
  592.  
  593.  
  594.       The file is written as a text file with one lowercase word per
  595.       line, in the order that they were added. ALL words in the special
  596.       words list are written to the file. Use your text editor to modify
  597.       this list. If the special word list text file is stored alphabetically,
  598.       The user should use an editor to mix the words in a random order to
  599.       improve the speed performance of the program.
  600.  
  601.   Concordance - command
  602.  
  603.       Pressing 'C' will allow the user to save the concordance, a list
  604.       of unique words, and how many times each one is used, to a disk
  605.       file. The user will be asked to enter the file name of the
  606.       concordance file to be saved. If the file exists, the user will be
  607.       asked if he wishes to overwrite that file or not.
  608.  
  609.       The file is written as a text file with one lowercase word, the
  610.       quantity used, and optionally, the letter 'S' if the word is in
  611.       the special word list, per line. The words are in alphabetical
  612.       order.
  613.  
  614.  
  615.  
  616. MINIDOS - menu:
  617. ---------------
  618.  
  619.  
  620. ╔═════════════════════════════════════════════════════════════════════════════╗
  621. ║ FolkSpeller - Copyright The FolksWare Company, 1985,1986   VER 3.1          ║
  622. ╠═════════════════════════════════════════════════════════════════════════════╣
  623. ║                                                                             ║
  624. ║<MINIDOS> Cmds= DIR  CHD(CD)  REN  COPy  DEL(ERA)  TYP  CLS  Help  Quit <CR> ║
  625. ╚═════════════════════════════════════════════════════════════════════════════╝
  626.  
  627.  
  628.   MiniDOS is a DOS like shell utility that allows the user to do some file
  629.   manipulation while using FolkSpeller. It is designed to operate
  630.   very much like IBM-DOS or MS-DOS, with a few enhancements.
  631.  
  632.   The prompt '[B:]' indicates the default drive is 'B' .
  633.  
  634.   The DOS commands that are supported in modified form are:
  635.  
  636.              DIR ------------- Directory    (globals  *,? )
  637.              CHD or CD ------- Change Directory
  638.              REN ------------- Rename file  (no globals)
  639.              COPy ------------ Copy file    (no globals)
  640.              DEL or ERA ------ Delete file  (no globals)
  641.              TYP ------------- Type file
  642.              CLS ------------- Clear Screen
  643.  
  644.  
  645.  
  646.     FOLKSPELLER, Copyright The FolksWare Company, 1985,1986
  647.  
  648.  
  649.   MiniDOS requires only the first three letters of most commands as
  650.   shown above, but will accept full commands such as 'RENAME'.  MiniDOS is
  651.   not case dependent.  MiniDOS will also help the user complete commands
  652.   if only a partial command is entered. For instance, to copy one file to
  653.   another disk using MiniDOS, if you enter only COPy, MiniDOS will ask you
  654.   for the file name, and the destination.
  655.  
  656.   DIRectory - command
  657.  
  658.      The current directory will be displayed on the screen in the
  659.      wide format starting with the directory name, the files, the
  660.      disk space used, and the volume name if it exists. Global
  661.      characters may be used as in DOS.
  662.  
  663.              Ex: [A:] dir b:fred??.*
  664.  
  665.   CHDir or CD - command
  666.  
  667.      The user may change the current directory of the default disk
  668.      drive.
  669.  
  670.              Ex:  [C:] cd /fred/letters
  671.  
  672.   REName - command
  673.  
  674.      Renames a file on a disk. If the new file name already exist,
  675.      the file will not be renamed. Globals are not allowed.
  676.  
  677.  
  678.              Ex:  [B:] rename c:fred.txt fred.4
  679.                   (file is renamed on c: drive)
  680.  
  681.   COPy - command
  682.  
  683.      Copies a file from a disk to another disk. It will not allow
  684.      copying to the same disk with the same name.  You may rename
  685.      the file, and copy to the same disk. Globals are not allowed.
  686.  
  687.  
  688.              Ex:  [B:] Copy fred.txt fred.444
  689.  
  690.      If you enter 'COPY CON:filename' then a text file will be
  691.      created using the keyboard input for the source. You must enter
  692.      the character '}'as the first character on the last line to
  693.      terminate the file. The last line is not written to the file.
  694.  
  695.  
  696.              Ex:  [B:] Copy con:list.wrd
  697.  
  698.  
  699.  
  700.  
  701.     FOLKSPELLER, Copyright The FolksWare Company, 1985,1986
  702.  
  703.  
  704.    DELete or ERAse - command
  705.  
  706.       Deletes a file from a disk. User must verify the deletion.
  707.       Globals are not allowed.
  708.  
  709.              Ex:  [C:] erase b:fred.444
  710.  
  711.  
  712.    TYPe - command
  713.  
  714.       Types a file to the screen as in DOS, except, it pauses after
  715.       15 lines have been displayed. Pressing any key continues the
  716.       typing of the file. Pressing the ESCape key will terminate
  717.       typing the file at the pause.
  718.  
  719.              Ex:  [A:] TYPE FRED.TXT
  720.  
  721.    Other commands
  722.  
  723.       'CLS' - will clear the window area.
  724.       'Q'- will return to the main menu.
  725.       'H'- will pop up a help screen.
  726.       'Cntl-X'- will erase the current command.
  727.       'Cntl-R'- will recall the last command entered.
  728.       'Cntl-D'- will recall one character of the last command at a
  729.                 time.
  730.       Change the default drive the same as DOS.('B:' = B drive)
  731.  
  732.  
  733.  
  734. 3. Configuring FolkSpeller
  735. --------------------------
  736.  
  737.    FolkSpeller can be configured to operate in different ways. After
  738.    starting FolkSpeller, when in the main menu, type 'CONF'.  The screen
  739.    will be erased, and replaced with the configure screen.
  740.  
  741.    To change any existing value, just enter a new value. If you do not
  742.    want to change a value, just press the carriage return key. You must
  743.    enter or accept the following information:
  744.  
  745.    1) Default file drive (where to look for documents)
  746.        This can also be changed by adding a drive specifier to the file
  747.        name, or by using MiniDOS.
  748.    2) Dictionary drive (where to find the dictionary)
  749.        If a dictionary does not exist on this drive, one will be
  750.        created with a few key words.
  751.    3) The character used to mark words(choose one displayed)
  752.  
  753.  
  754.  
  755.  
  756.     FOLKSPELLER, Copyright The FolksWare Company, 1985,1986
  757.  
  758.  
  759.    Answer the following questions:
  760.  
  761.    4) Do you want to create Concordance? Y/N
  762.        Answering 'Y' will cause the program to store every unique word
  763.        that it looks up in a concordance file in memory. Words will not
  764.        be added to the concordance unless you answer 'Y'es.
  765.    5) Do you want to Auto-Replace words? Y/N
  766.        Answering 'Y' will cause the program to automatically replace
  767.        corrected spelling of words it finds more than once.
  768.  
  769.  
  770.    A color bar is displayed for color machines, and you may set the
  771.    display colors for your version.
  772.  
  773.    1   2   3   4   5   6   7   8   9  10  11  12  13  14  15
  774.  
  775.    6) Enter Normal Text color (1..15)
  776.    7) Enter Menu Background color (1..8)
  777.    8) Enter Hilighted Text color (1..15)
  778.  
  779.    You are now finished with the configuration, and you will be asked,
  780.    'Do you wish to USE, SAVE & use, REDO these values?'.
  781.  
  782.        Pressing 'U' or the carriage return will use these values for the
  783.        program. Pressing 'S' will save these values in a file, FSPELL.CFG, as
  784.        well as using them for the program. If the file created, FSPELL.CFG is
  785.        on the disk when the program is restarted, these values will be
  786.        recalled and used. Pressing 'R' will start the configuration process.
  787.  
  788.  
  789.  
  790. 4.TIPS
  791. ------
  792.  
  793.     RAM Drives:
  794.        Since FolkSpeller has to look up words in a file that is stored on a
  795.        disk, it lends itself to operation using a RAM drive in memory. If
  796.        your machine has enough memory to create a RAM drive large enough to
  797.        store the dictionary, you may make the operation of FolkSpeller very
  798.        fast by using the RAM drive. During the configuration of FolkSpeller,
  799.        you will need to change the dictionary drive designator to the RAM
  800.        drive designator. Remember, that the RAM drive must hold the entire
  801.        dictionary plus any new words that are added. The dictionary requires
  802.        approximately 10 bytes per word for storage. Copy the dictionary back
  803.        to the disk before turning off the machine, or all new words added to
  804.        it will be lost.
  805.  
  806.  
  807.  
  808.     FOLKSPELLER, Copyright The FolksWare Company, 1985,1986
  809.  
  810.  
  811.    CONCORDANCE:
  812.        The generation of a concordance file is controllable from the
  813.        configuration menu option. With the concordance off, and using a
  814.        normal disk for the dictionary, the computer will look up each and
  815.        every word that you have in a document that you are checking. This
  816.        method will cause the program to be somewhat slow, and is not
  817.        recommended.
  818.  
  819.        When FolkSpeller is set to generate a concordance, each unique word is
  820.        stored in memory after it is looked up. This means that the program
  821.        will only look up the word in the dictionary once per session. The
  822.        speed of the program will depend on the number of unique words in the
  823.        documents. Generally, the longer the document, the faster the program
  824.        will get.
  825.  
  826.        At the end of a session, you may save the concordance as an
  827.        alphabetically arranged list of unique words used. This list may be
  828.        used by the writer to assess the extent of his/her vocabulary. The
  829.        list may also be used by The FolksWare Company's FolksDexer program
  830.        that is in development at this time. FolksDexer will create an index
  831.        of a document, using a word input list as the basis.
  832.  
  833.     Special dictionaries.
  834.  
  835.        FolkSpeller can be used to check more than just reports, manuals, or
  836.        articles. Since FolkSpeller creates a new dictionary if one is not
  837.        available on the designated drive, specialized dictionaries may be
  838.        created by the user. A Pascal dictionary may be created to check a
  839.        source program, or optionally, to automatically replace words in the
  840.        source code. To do this, you would first start with a new dictionary.
  841.        To use FolkSpeller with a new dictionary, see the parameters below.
  842.        As you find a variable name that you want replaced, instead of
  843.        accepting it and adding it to the dictionary, you first correct it to
  844.        the new name. As the source code is read, FolkSpeller will allow you
  845.        to replace the old with the new each time it finds the old name. If
  846.        FolkSpeller is configured for automatic replacement, it will do this
  847.        without stopping.
  848.  
  849.        You may also find the need for a foreign language dictionary which you
  850.        may create by checking a document without using your main dictionary.
  851.        The dictionary is limited, however, to the English alphabet.
  852.  
  853.  
  854.  
  855.     FOLKSPELLER, Copyright The FolksWare Company, 1985,1986
  856.  
  857.  
  858.    PARAMETERS:
  859.  
  860.        There are some optional parameters that can be used when loading
  861.        FolkSpeller into memory. To use any of them, simply add them to the
  862.        command line when calling FolkSpeller.
  863.  
  864.        Special word lists can be added by specifying them with parameters.
  865.  
  866.          Ex: FSPELL S=MEDICAL.LST  will automatically load the words in
  867.          medical.lst to the special word list in the program. More than one
  868.          list can be loaded by adding more parameters.
  869.  
  870.        Special dictionaries may be used automatically by specifying them on
  871.        the command line.
  872.          Ex: FSPELL D=PASCAL.DCT will use only the Pascal special dictionary.
  873.              The default is FSPELL.DCT.
  874.  
  875.        Other parameters may be found in the FSPMORE.DOC file that comes on The
  876.        FolksWare Dictionary disk.
  877.  
  878. 5. CONCLUSION
  879.    ----------
  880.  
  881.        Version 1 was the conceptual program, written in BASIC and was
  882.        never released to the public.
  883.  
  884.        Version 2 was written and compiled using Turbo Pascal, using the B+tree
  885.        indexing system found in Borland's Turbo ToolBox. We used this version
  886.        to debug the presentation, as the Turbo ToolBox indexing system is
  887.        not adequate for this kind of program.
  888.  
  889.        Version 3 used our own dictionary management package, and had all the
  890.        temporary,special, and concordance portions added. Replacement of
  891.        words, and a new MiniDOS package was also added. This version saw
  892.        very limited distribution.
  893.  
  894.        Version 3.1 added the FIND command, and fixed a bug in the available
  895.        memory test at the front of the program that on large memory IBM's,
  896.        (not my AT&T 6300) would not allow the program to run.
  897.  
  898.        Version 3.1 is the first full release of the program. Previous
  899.        distribution has been to several friends and local people in order
  900.        to get the program debugged. A special thanks to all those people
  901.        who have taken the time to test and evaluate the program. Without their
  902.        impartial unbiased evaluation, several small things may have been
  903.        overlooked. Of course, they get free copies with our sincere thanks.
  904.        Thanks JD.....
  905.  
  906.  
  907.  
  908.     FOLKSPELLER, Copyright The FolksWare Company, 1985,1986
  909.  
  910.  
  911.        When you purchase the program along with The FolksWare Dictionary, you
  912.        will also receive additional documentation describing other
  913.        parameters that you may use with FolkSpeller, and a list of
  914.        error messages.
  915.  
  916.        Turbo Pascal and Turbo Toolbox are registered trademarks of Borland
  917.        International.
  918.  
  919.        IBM is a registered trademark of the International Business Machine
  920.        Company.
  921.  
  922.        AT&T 6300 is the registered trademark of AT&T.
  923.  
  924.    Any suggestions for program improvement will be gladly accepted, and
  925.    reviewed for possible implementation in future releases. If there is a
  926.    bug in the program, please let us know about it.
  927.  
  928.    User supported software depends very much on the honesty of the users
  929.    themselves. We think we have produced a valuable tool for PC users, at
  930.    a very reasonable price. Be honest with yourself, and if you use the
  931.    program, then send your purchase request now. Some people and
  932.    companies believe that shareware does not have to be paid for, but
  933.    they are wrong. The FolksWare Company trusts you, the user, to support
  934.    us in this marketing method.
  935.  
  936.    LAST MINUTE ADDITIONS:
  937.  
  938.    A bar at the bottom of the screen now reports several status items. In
  939.    order from left to right:
  940.      1) The default disk drive for the document,
  941.      2) The file being checked,
  942.      3) The name of the dictionary being used,
  943.      4) The word 'SPECIAL' if a special word list has been added,
  944.      5) The word 'CONC' if the concordance option is active,
  945.      6) The word 'AUTO' if the auto-replace option is active,
  946.      7) and the word 'NOTPAID' if you have not purchased FolkSpeller.
  947.  
  948.    If you need to access the dictionary in another subdirectory, you may
  949.    specify the dictionary path by including the parameter "P={path}".
  950.  
  951.    EXAMPLE: P=\edit\dicts\     {40 characters max} NOTE the back slashes!
  952.  
  953.    The drive is specified in the configure file FSPELL.CFG or from the
  954.    configure option.
  955.  
  956.  
  957.  
  958.     FOLKSPELLER, Copyright The FolksWare Company, 1985,1986
  959.  
  960.  
  961.    5. RECCOMENDATIONS for configuration.....
  962.  
  963.    ONE DRIVE MACHINES WITH 256+K
  964.      Text Drive = A
  965.      Dictionary = A
  966.      Concordance ON
  967.      Copy Dictionary to Text Disk
  968.  
  969.    TWO DRIVE MACHINES WITH 256+K
  970.      Text Drive = A
  971.      Dictionary = B
  972.      Concordance ON
  973.  
  974.    TWO DRIVE MACHINES WITH 640K
  975.      Text Drive = A
  976.      Dictionary = C (Ram Drive)
  977.      Concordance ON (If you desire)
  978.  
  979.    HARD DRIVE MACHINES WITH 256+K
  980.      Text Drive = B
  981.      Dictionary = C (Hard Drive)
  982.      Concordance ON (If you desire)
  983.  
  984. You can try other combinations, and determine which works best for you...
  985.  
  986. FolkSpeller does not use overlays or other files after the initial
  987. start of the program, after you have received the prompt "Press any key
  988. to continue" you may remove the disk containing FolkSpeller. If you want
  989. to reconfigure the program, and save this new configuration (FSPELL.CFG),
  990. you must replace the disk in the drive. FSPELL.CFG must be on the disk
  991. in order to load the new configuration.
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.     FOLKSPELLER, Copyright The FolksWare Company, 1985,1986
  999.  
  1000.  
  1001.  
  1002.